home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / SetRecLmt.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tcl_SetRecursionLimit(3T)cl Library Procedures                  7.0
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tcl_SetRecursionLimit - set maximum allowable nesting  depth
  12.      in interpreter
  13.  
  14. SYNOPSIS
  15.      #include <tcl.h>
  16.  
  17.      int
  18.      Tcl_SetRecursionLimit(_i_n_t_e_r_p, _d_e_p_t_h)
  19.  
  20. ARGUMENTS
  21.      Tcl_Interp   *_i_n_t_e_r_p   (in)      Interpreter whose recursion
  22.                                       limit  is  to be set.  Must
  23.                                       be greater than zero.
  24.  
  25.      int          _d_e_p_t_h     (in)      New limit for nested  calls
  26.                                       to Tcl_Eval for _i_n_t_e_r_p.
  27. _________________________________________________________________
  28.  
  29.  
  30. DESCRIPTION
  31.      At any given time Tcl enforces a  limit  on  the  number  of
  32.      recursive  calls that may be active for Tcl_Eval and related
  33.      procedures such as Tcl_GlobalEval.   Any  call  to  Tcl_Eval
  34.      that  exceeds  this  depth  is  aborted  with  an error.  By
  35.      default the recursion limit is 1000.
  36.  
  37.      Tcl_SetRecursionLimit may be  used  to  change  the  maximum
  38.      allowable nesting depth for an interpreter.  The _d_e_p_t_h argu-
  39.      ment   specifies   a   new    limit    for    _i_n_t_e_r_p,    and
  40.      Tcl_SetRecursionLimit  returns  the  old limit.  To read out
  41.      the    old    limit    without    modifying    it,    invoke
  42.      Tcl_SetRecursionDepth with _d_e_p_t_h equal to 0.
  43.  
  44.  
  45. KEYWORDS
  46.      nesting depth, recursion
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.